home *** CD-ROM | disk | FTP | other *** search
ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) NNNNAAAAMMMMEEEE _cccc_oooo_nnnn_ffff_ssss_tttt_rrrr - get configurable variables SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee <_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh> _ssss_iiii_zzzz_eeee______tttt _cccc_oooo_nnnn_ffff_ssss_tttt_rrrr _((((_iiii_nnnn_tttt _nnnn_aaaa_mmmm_eeee_,,,, _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_,,,, _ssss_iiii_zzzz_eeee______tttt _llll_eeee_nnnn_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _cccc_oooo_nnnn_ffff_ssss_tttt_rrrr copies information relating to the UNIX system on which the process is executing into the buffer pointed to by _b_u_f. _l_e_n is the size of the buffer. The POSIX P1003.1 interface _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff [see _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(2)] provides a similar class of configuration information, but returns an integer rather than a string. The _c_o_m_m_a_n_ds available are: ______CCCC_SSSS______SSSS_YYYY_SSSS_NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee [see _uuuu_nnnn_aaaa_mmmm_eeee(2)] in the _s_y_s_n_a_m_e field. This is the name of the implementation of the operating system, for example, _S_y_s_t_e_m _V or _U_T_S. ______CCCC_SSSS______HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string that names the present host machine. This is the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _n_o_d_e_n_a_m_e field. This hostname or nodename is often the name the machine is known by locally. The _h_o_s_t_n_a_m_e is the name of this machine as a node in some network; different networks may have different names for the node, but presenting the nodename to the appropriate network Directory or name-to-address mapping service should produce a transport end point address. The name may not be fully qualified. Internet host names may be up to 256 bytes in length (plus the terminating null). ______CCCC_SSSS______RRRR_EEEE_LLLL_EEEE_AAAA_SSSS_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _r_e_l_e_a_s_e field. Typical values might be _4._0 or _3._2. ______CCCC_SSSS______VVVV_EEEE_RRRR_SSSS_IIII_OOOO_NNNN Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _v_e_r_s_i_o_n field. The syntax and semantics of this string are defined by the system provider. Under IRIX, this is the date and time that the system was generated and has the form mmmmmmmmddddddddhhhhhhhhmmmmmmmm. ______CCCC_SSSS_MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE Copy into the array pointed to by _b_u_f the string that would be returned by _uuuu_nnnn_aaaa_mmmm_eeee in the _m_a_c_h_i_n_e field, for example, _I_P_2_7 or _I_P_3_0. PPPPaaaaggggeeee 1111 ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ______CCCC_SSSS______AAAA_RRRR_CCCC_HHHH_IIII_TTTT_EEEE_CCCC_TTTT_UUUU_RRRR_EEEE Copy into the array pointed to by _b_u_f a string describing the instruction set architecture of the current system, for example, _M_I_P_S-_I_I, _m_3_2_1_0_0, or _i_8_0_4_8_6. These names may not match predefined names in the C language compilation system. ______CCCC_SSSS______HHHH_WWWW______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR Copies the name of the hardware manufacturer into the array pointed to by _b_u_f. ______CCCC_SSSS______HHHH_WWWW______SSSS_EEEE_RRRR_IIII_AAAA_LLLL Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the 32 bit hardware-specific identifier of the physical machine on which the system call is executed. Note that this may be implemented in Read- Only Memory, via software constants set when building the operating system, or by other means, and may contain non- numeric characters. It is anticipated that manufacturers will not issue the same ``32-bit identifier'' to more than one physical machine. The pair of strings returned by ______CCCC_SSSS______HHHH_WWWW______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR and ______CCCC_SSSS______HHHH_WWWW______SSSS_EEEE_RRRR_IIII_AAAA_LLLL is likely to be unique across all vendor's System V implementations. ______CCCC_SSSS______IIII_NNNN_IIII_TTTT_TTTT_AAAA_BBBB______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string that is the pathname of the _iiii_nnnn_iiii_tttt_tttt_aaaa_bbbb file used by the currently running bootable operating system. This is the same as the file specified by the _IIII_NNNN_IIII_TTTT_TTTT_AAAA_BBBB keyword found in the _ssss_yyyy_ssss_tttt_eeee_mmmm file [see _ssss_yyyy_ssss_tttt_eeee_mmmm(4)]. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______VVVV_EEEE_NNNN_DDDD_OOOO_RRRR Copy into the array pointed to by _b_u_f a string which is the name of the company providing the system. The vendor is the company actually selling the product rather than the company which built the product. Eg: "Silicon Graphics Inc". ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______OOOO_SSSS______PPPP_RRRR_OOOO_VVVV_IIII_DDDD_EEEE_RRRR Copy into the array pointed to by _b_u_f a string which is the name of the company providing the operating system. This is the name of the company which built the operating system. Eg: "Silicon Graphics Inc". ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______OOOO_SSSS______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string which is the name of the operating system. Eg: "IRIX". ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______HHHH_WWWW______NNNN_AAAA_MMMM_EEEE Copy into the array pointed to by _b_u_f a string which is the name of the hardware platform. This is the name of the platform in the pricelist. Eg: "IP19" PPPPaaaaggggeeee 2222 ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______NNNN_UUUU_MMMM______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the number of configured processors. Eg: "16" ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______HHHH_OOOO_SSSS_TTTT_IIII_DDDD Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the host id in hex. This example uses sgi.sgi.com, which has an internet address of 192.26.75.5. Eg: "c01a4b05" ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______OOOO_SSSS_RRRR_EEEE_LLLL______MMMM_AAAA_JJJJ Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS major release number. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______OOOO_SSSS_RRRR_EEEE_LLLL______MMMM_IIII_NNNN Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS minor release number. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______OOOO_SSSS_RRRR_EEEE_LLLL______PPPP_AAAA_TTTT_CCCC_HHHH Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the OS patch release number. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the processor type. In the case of a multiprocessor, this will be a comma separated list with _MIPS_CS_NUM_PROCESSORS entries. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______AAAA_VVVV_AAAA_IIII_LLLL______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR_SSSS Copy into the array pointed to by _b_u_f a string which is the ASCII representation of the number of processors available for running unrestricted processes. ______MMMM_IIII_PPPP_SSSS______CCCC_SSSS______SSSS_EEEE_RRRR_IIII_AAAA_LLLL This is the same as ______CCCC_SSSS______HHHH_WWWW______SSSS_EEEE_RRRR_IIII_AAAA_LLLL. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_3333_2222______CCCC_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as compilation options to _c_c for a 32-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_3333_2222______LLLL_DDDD_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as linking options to _c_c for a 32-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_3333_2222______LLLL_IIII_BBBB_SSSS Copy into the array pointed to by _b_u_f a string which can be given as library options to _c_c for a 32-bit programming model. PPPPaaaaggggeeee 3333 ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_3333_2222______LLLL_IIII_NNNN_TTTT_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as options to _l_i_n_t for a 32-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______CCCC_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as compilation options to _c_c for a 32-bit with long off_t programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_DDDD_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as linking options to _c_c for a 32-bit with long off_t programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_IIII_BBBB_SSSS Copy into the array pointed to by _b_u_f a string which can be given as library options to _c_c for a 32-bit with long off_t programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______IIII_LLLL_PPPP_3333_2222______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_IIII_NNNN_TTTT_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as options to _l_i_n_t for a 32-bit with long off_t programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_6666_4444______OOOO_FFFF_FFFF_6666_4444______CCCC_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as compilation options to _c_c for a 64-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_6666_4444______OOOO_FFFF_FFFF_6666_4444______LLLL_DDDD_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as linking options to _c_c for a 64-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_6666_4444______OOOO_FFFF_FFFF_6666_4444______LLLL_IIII_BBBB_SSSS Copy into the array pointed to by _b_u_f a string which can be given as library options to _c_c for a 64-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_6666_4444______OOOO_FFFF_FFFF_6666_4444______LLLL_IIII_NNNN_TTTT_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as options to _l_i_n_t for a 64-bit programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_BBBB_IIII_GGGG______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______CCCC_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as compilation options to _c_c for a 64-bit or greater programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_BBBB_IIII_GGGG______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_DDDD_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as linking options to _c_c for a 64-bit or greater programming model. PPPPaaaaggggeeee 4444 ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ccccoooonnnnffffssssttttrrrr((((3333SSSS)))) ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_BBBB_IIII_GGGG______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_IIII_BBBB_SSSS Copy into the array pointed to by _b_u_f a string which can be given as library options to _c_c for a 64-bit or greater programming model. ______CCCC_SSSS______XXXX_BBBB_SSSS_5555______LLLL_PPPP_BBBB_IIII_GGGG______OOOO_FFFF_FFFF_BBBB_IIII_GGGG______LLLL_IIII_NNNN_TTTT_FFFF_LLLL_AAAA_GGGG_SSSS Copy into the array pointed to by _b_u_f a string which can be given as options to _l_i_n_t for a 64-bit or greater programming model. _cccc_oooo_nnnn_ffff_ssss_tttt_rrrr fails if the following is true: _EEEE_IIII_NNNN_VVVV_AAAA_LLLL _b_u_f does not point to a valid address. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS Upon successful completion, the value returned indicates the buffer size in bytes required to hold the complete value and the terminating null character. If this value is no greater than the value passed in _l_e_n, the entire string was copied; if this value is greater than _l_e_n, the string copied into _b_u_f has been truncated to _l_e_n-_1 bytes plus a terminating null character. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error. UUUUSSSSAAAAGGGGEEEE A good starting guess for _l_e_n is 257, which is likely to cover all strings returned by this interface in typical installations. SSSSEEEEEEEE AAAALLLLSSSSOOOO _uuuu_nnnn_aaaa_mmmm_eeee(2), _gggg_eeee_tttt_hhhh_oooo_ssss_tttt_nnnn_aaaa_mmmm_eeee(3), _gggg_eeee_tttt_hhhh_oooo_ssss_tttt_iiii_dddd(3), _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C), _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>, _<<<<_rrrr_eeee_gggg_eeee_xxxx_pppp_...._hhhh_>>>> PPPPaaaaggggeeee 5555 
